@intranefr/superbackend 1.4.4 → 1.5.1

package/.env.example

@@ -50,3 +50,8 @@ MAX_FILE_SIZE_HARD_CAP=10485760
 # Encryption key for encrypted settings (new preferred name)
 # SUPERBACKEND_ENCRYPTION_KEY=your-32-byte-encryption-key
 # Legacy fallback: SAASBACKEND_ENCRYPTION_KEY=your-32-byte-encryption-key
+
+# Console Manager
+# Set to 'false' to disable console manager initialization
+# When disabled, console methods are not overridden and no console entries are tracked
+# CONSOLE_MANAGER_ENABLED=true

package/README.md

@@ -23,6 +23,13 @@ Node.js middleware that gives your project backend superpowers. Handles authenti
 - **Webhooks**: Outgoing webhook system for event-driven integrations
 - **Metrics & Activity**: Usage tracking and analytics for business insights
 - **Middleware Mode**: Drop-in Express middleware that preserves your app structure
+- **Workflows System**: Node-based automation with LLM integration, conditionals, and HTTP calls
+- **LLM UI Integration**: AI-powered UI components and conversational interfaces
+- **Admin Scripts & Terminals**: Operational tooling for script execution and terminal management
+- **Migration System**: Database migration and data transfer between environments
+- **Upload Namespaces**: Advanced file organization with customizable storage rules
+- **UI Components**: Project-scoped reusable UI widgets with browser SDK integration
+- **UI Components AI Assistance**: AI-powered generation and iteration of UI component code
 
 ---
 
@@ -85,6 +92,10 @@ See the `docs/features/` directory for detailed guides:
 - [Core Configuration](docs/features/core-configuration.md)
 - [Admin API Usage](docs/features/admin-api-usage.md)
 - [Billing & Subscriptions](docs/features/billing-and-subscriptions.md)
+- [Workflows System](docs/features/workflows-system.md)
+- [LLM UI Integration](docs/features/llm-ui-integration.md)
+- [Migration System](docs/features/migration-system.md)
+- [Upload Namespaces](docs/features/upload-namespaces.md)
 
 ---
 

package/index.js

@@ -11,6 +11,7 @@ const express = require("express");
  * @returns {express.Router} Configured Express router
  */
 const middleware = require("./src/middleware");
+const { attachTerminalWebsocketServer } = require('./src/services/terminalsWs.service');
 
 /**
  * Creates and starts a standalone SuperBackend server
@@ -24,13 +25,26 @@ function startServer(options = {}) {
   const app = express();
   const PORT = options.port || process.env.PORT || 3000;
 
-  app.use(module.exports.middleware(options));
+  const router = module.exports.middleware(options);
+  app.use(router);
 
   // Start server
   const server = app.listen(PORT, () => {
     console.log(`🚀 SuperBackend standalone server running on http://localhost:${PORT}`);
   });
 
+  // Attach WebSocket server via middleware helper or directly
+  console.log('[Index] Attaching WebSocket server...');
+  if (typeof router.attachWs === 'function') {
+    console.log('[Index] Using router.attachWs');
+    router.attachWs(server);
+  } else {
+    // Fallback: attach directly with admin path
+    const adminPath = router.adminPath || '/admin';
+    console.log('[Index] Using fallback attach with adminPath:', adminPath);
+    attachTerminalWebsocketServer(server, { basePathPrefix: adminPath });
+  }
+
   return { app, server };
 }
 
@@ -48,6 +62,8 @@ const saasbackend = {
     storage: require("./src/services/storage"),
     i18n: require("./src/services/i18n.service"),
     audit: require("./src/services/audit.service"),
+    cacheLayer: require("./src/services/cacheLayer.service"),
+    rbac: require("./src/services/rbac.service"),
     globalSettings: require("./src/services/globalSettings.service"),
     jsonConfigs: require("./src/services/jsonConfigs.service"),
     assets: require("./src/services/assets.service"),
@@ -58,12 +74,24 @@ const saasbackend = {
     forms: require("./src/services/forms.service"),
     webhooks: require("./src/services/webhook.service"),
     workflow: require("./src/services/workflow.service"),
+    healthChecks: require("./src/services/healthChecks.service"),
+    dbBrowser: require("./src/services/dbBrowser.service"),
+    rateLimiter: require("./src/services/rateLimiter.service"),
   },
   models: {
     ActionEvent: require("./src/models/ActionEvent"),
     ActivityLog: require("./src/models/ActivityLog"),
     Asset: require("./src/models/Asset"),
     AuditEvent: require("./src/models/AuditEvent"),
+    CacheEntry: require("./src/models/CacheEntry"),
+    RateLimitCounter: require("./src/models/RateLimitCounter"),
+    RateLimitMetricBucket: require("./src/models/RateLimitMetricBucket"),
+    RbacRole: require("./src/models/RbacRole"),
+    RbacUserRole: require("./src/models/RbacUserRole"),
+    RbacGroup: require("./src/models/RbacGroup"),
+    RbacGroupMember: require("./src/models/RbacGroupMember"),
+    RbacGroupRole: require("./src/models/RbacGroupRole"),
+    RbacGrant: require("./src/models/RbacGrant"),
     EmailLog: require("./src/models/EmailLog"),
     ErrorAggregate: require("./src/models/ErrorAggregate"),
     FormSubmission: require("./src/models/FormSubmission"),
@@ -85,12 +113,22 @@ const saasbackend = {
     Webhook: require("./src/models/Webhook"),
     Workflow: require("./src/models/Workflow"),
     WorkflowExecution: require("./src/models/WorkflowExecution"),
+
+    HealthCheck: require("./src/models/HealthCheck"),
+    HealthCheckRun: require("./src/models/HealthCheckRun"),
+    HealthIncident: require("./src/models/HealthIncident"),
+    HealthAutoHealAttempt: require("./src/models/HealthAutoHealAttempt"),
+
+    ExternalDbConnection: require("./src/models/ExternalDbConnection"),
   },
   helpers: {
     auth: require("./src/middleware/auth"),
     org: require("./src/middleware/org"),
+    rbac: require("./src/middleware/rbac"),
     i18n: require("./src/services/i18n.service"),
     jsonConfigs: require("./src/services/jsonConfigs.service"),
+    terminals: require("./src/services/terminalsWs.service"),
+    rateLimiter: require("./src/services/rateLimiter.service"),
   },
 };
 

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@intranefr/superbackend",
-  "version": "1.4.4",
+  "version": "1.5.1",
   "description": "Node.js middleware that gives your project backend superpowers",
   "main": "index.js",
   "scripts": {
     "start": "node server.js",
-    "dev": "nodemon server.js",
+    "dev": "nodemon --verbose --ignore uploads --ignore '*.log' server.js",
     "start:minio": "docker compose -f compose.standalone.yml --profile minio-only up -d minio",
     "minio:envs": "node -e \"console.log(['S3_ENDPOINT=http://localhost:9000','S3_REGION=us-east-1','S3_ACCESS_KEY_ID=minioadmin','S3_SECRET_ACCESS_KEY=minioadmin','S3_BUCKET=saasbackend','S3_FORCE_PATH_STYLE=true'].join('\\n'))\"",
     "build:sdk:error-tracking:browser": "esbuild sdk/error-tracking/browser/src/embed.js --bundle --format=iife --global-name=saasbackendErrorTrackingEmbed --outfile=sdk/error-tracking/browser/dist/embed.iife.js",
+    "build:sdk:ui-components:browser": "esbuild sdk/ui-components/browser/src/index.js --bundle --format=iife --outfile=public/sdk/ui-components.iife.js",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage"
@@ -35,17 +36,24 @@
     "bcryptjs": "^2.4.3",
     "cheerio": "^1.0.0-rc.12",
     "cors": "^2.8.5",
+    "cron-parser": "3.5.0",
     "dotenv": "^16.3.1",
     "ejs": "^3.1.9",
     "express": "^4.18.2",
     "jsonwebtoken": "^9.0.2",
+    "marked": "^4.3.0",
     "mongoose": "^8.0.0",
     "multer": "^1.4.5-lts.1",
+    "mysql2": "^3.16.1",
+    "node-cron": "^4.2.1",
+    "node-pty": "^1.1.0",
     "openai": "^4.0.0",
+    "redis": "^4.7.1",
     "resend": "^6.4.0",
     "ssh2-sftp-client": "^12.0.1",
     "stripe": "^14.0.0",
-    "vm2": "^3.10.0"
+    "vm2": "^3.10.0",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
     "esbuild": "^0.25.0",

package/public/sdk/ui-components.iife.js

@@ -0,0 +1,191 @@
+(() => {
+  // sdk/ui-components/browser/src/index.js
+  (function() {
+    function toStr(v) {
+      return v === void 0 || v === null ? "" : String(v);
+    }
+    function normalizeApiUrl(apiUrl) {
+      const u = toStr(apiUrl).trim();
+      if (!u) return "";
+      return u.replace(/\/$/, "");
+    }
+    function buildHeaders(apiKey) {
+      const headers = {};
+      const key = toStr(apiKey).trim();
+      if (key) headers["x-project-key"] = key;
+      return headers;
+    }
+    async function fetchJson(url, headers) {
+      const res = await fetch(url, { headers: headers || {} });
+      const text = await res.text();
+      let data = null;
+      try {
+        data = text ? JSON.parse(text) : null;
+      } catch {
+        data = null;
+      }
+      if (!res.ok) {
+        const msg = data && data.error ? data.error : "Request failed";
+        const err = new Error(msg);
+        err.status = res.status;
+        throw err;
+      }
+      return data;
+    }
+    function ensureTemplate(code, html) {
+      const id = "ui-cmp-" + code;
+      let tpl = document.getElementById(id);
+      if (!tpl) {
+        tpl = document.createElement("template");
+        tpl.id = id;
+        document.body.appendChild(tpl);
+      }
+      tpl.innerHTML = toStr(html);
+      return tpl;
+    }
+    function injectCssScoped(code, cssText) {
+      const id = "ui-cmp-style-" + code;
+      let el = document.getElementById(id);
+      if (!el) {
+        el = document.createElement("style");
+        el.id = id;
+        document.head.appendChild(el);
+      }
+      el.textContent = toStr(cssText);
+    }
+    function createShadowRootContainer() {
+      const host = document.createElement("div");
+      host.style.all = "initial";
+      const shadow = host.attachShadow({ mode: "open" });
+      return { host, shadow };
+    }
+    function defaultMountTarget() {
+      return document.body;
+    }
+    function compileComponentJs(jsCode) {
+      const code = toStr(jsCode);
+      if (!code.trim()) {
+        return function() {
+          return {};
+        };
+      }
+      return new Function("api", "templateRootEl", "props", code);
+    }
+    const state = {
+      initialized: false,
+      projectId: null,
+      apiKey: null,
+      apiUrl: "",
+      cssIsolation: "scoped",
+      components: {}
+    };
+    function registerComponent(def) {
+      const code = toStr(def.code).trim().toLowerCase();
+      if (!code) return;
+      const version = def.version;
+      const html = def.html;
+      const js = def.js;
+      const css = def.css;
+      ensureTemplate(code, html);
+      const component = {
+        code,
+        version,
+        css,
+        js,
+        create: function(props, options) {
+          const opts = options || {};
+          const mountEl = opts.mountEl || defaultMountTarget();
+          const isolation = opts.cssIsolation || state.cssIsolation;
+          const tpl = ensureTemplate(code, html);
+          const fragment = tpl.content.cloneNode(true);
+          let templateRootEl;
+          let instanceRoot;
+          let shadow = null;
+          if (isolation === "shadow") {
+            const c = createShadowRootContainer();
+            instanceRoot = c.host;
+            shadow = c.shadow;
+            templateRootEl = shadow;
+            if (css) {
+              const style = document.createElement("style");
+              style.textContent = toStr(css);
+              shadow.appendChild(style);
+            }
+            shadow.appendChild(fragment);
+          } else {
+            instanceRoot = document.createElement("div");
+            templateRootEl = instanceRoot;
+            if (css) injectCssScoped(code, css);
+            instanceRoot.appendChild(fragment);
+          }
+          mountEl.appendChild(instanceRoot);
+          const api = {
+            unmount: function() {
+              try {
+                instanceRoot.remove();
+              } catch {
+              }
+            },
+            mountEl,
+            hostEl: instanceRoot,
+            shadowRoot: shadow
+          };
+          const fn = compileComponentJs(js);
+          let exported = {};
+          try {
+            exported = fn(api, templateRootEl, props || {}) || {};
+          } catch (e) {
+            exported = {
+              error: e
+            };
+          }
+          return Object.assign({ api }, exported);
+        }
+      };
+      state.components[code] = component;
+      uiCmp[code] = component;
+      uiComponents[code] = component;
+    }
+    async function init(options) {
+      const opts = options || {};
+      const projectId = toStr(opts.projectId).trim();
+      if (!projectId) throw new Error("projectId is required");
+      const apiUrl = normalizeApiUrl(opts.apiUrl);
+      const apiKey = opts.apiKey;
+      state.projectId = projectId;
+      state.apiKey = apiKey;
+      state.apiUrl = apiUrl;
+      const cssIsolation = toStr(opts.cssIsolation || "scoped").trim().toLowerCase();
+      state.cssIsolation = cssIsolation === "shadow" ? "shadow" : "scoped";
+      const base = state.apiUrl;
+      const url = base + "/api/ui-components/projects/" + encodeURIComponent(projectId) + "/manifest";
+      const data = await fetchJson(url, buildHeaders(apiKey));
+      const items = data && Array.isArray(data.components) ? data.components : [];
+      for (const def of items) {
+        registerComponent(def);
+      }
+      state.initialized = true;
+      return { project: data ? data.project : null, count: items.length };
+    }
+    async function load(code) {
+      const c = toStr(code).trim().toLowerCase();
+      if (!c) throw new Error("code is required");
+      if (!state.projectId) throw new Error("uiCmp not initialized");
+      if (state.components[c]) return state.components[c];
+      const base = state.apiUrl;
+      const url = base + "/api/ui-components/projects/" + encodeURIComponent(state.projectId) + "/components/" + encodeURIComponent(c);
+      const data = await fetchJson(url, buildHeaders(state.apiKey));
+      if (!data || !data.component) throw new Error("Component not found");
+      registerComponent(data.component);
+      return state.components[c];
+    }
+    const uiCmp = {
+      init,
+      load,
+      _state: state
+    };
+    const uiComponents = uiCmp;
+    window.uiCmp = uiCmp;
+    window.uiComponents = uiComponents;
+  })();
+})();

package/sdk/ui-components/browser/src/index.js

@@ -0,0 +1,228 @@
+(function () {
+  function toStr(v) {
+    return v === undefined || v === null ? '' : String(v);
+  }
+
+  function normalizeApiUrl(apiUrl) {
+    const u = toStr(apiUrl).trim();
+    if (!u) return '';
+    return u.replace(/\/$/, '');
+  }
+
+  function buildHeaders(apiKey) {
+    const headers = {};
+    const key = toStr(apiKey).trim();
+    if (key) headers['x-project-key'] = key;
+    return headers;
+  }
+
+  async function fetchJson(url, headers) {
+    const res = await fetch(url, { headers: headers || {} });
+    const text = await res.text();
+    let data = null;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      data = null;
+    }
+    if (!res.ok) {
+      const msg = data && data.error ? data.error : 'Request failed';
+      const err = new Error(msg);
+      err.status = res.status;
+      throw err;
+    }
+    return data;
+  }
+
+  function ensureTemplate(code, html) {
+    const id = 'ui-cmp-' + code;
+    let tpl = document.getElementById(id);
+    if (!tpl) {
+      tpl = document.createElement('template');
+      tpl.id = id;
+      document.body.appendChild(tpl);
+    }
+    tpl.innerHTML = toStr(html);
+    return tpl;
+  }
+
+  function injectCssScoped(code, cssText) {
+    const id = 'ui-cmp-style-' + code;
+    let el = document.getElementById(id);
+    if (!el) {
+      el = document.createElement('style');
+      el.id = id;
+      document.head.appendChild(el);
+    }
+    el.textContent = toStr(cssText);
+  }
+
+  function createShadowRootContainer() {
+    const host = document.createElement('div');
+    host.style.all = 'initial';
+    const shadow = host.attachShadow({ mode: 'open' });
+    return { host, shadow };
+  }
+
+  function defaultMountTarget() {
+    return document.body;
+  }
+
+  function compileComponentJs(jsCode) {
+    const code = toStr(jsCode);
+    if (!code.trim()) {
+      return function () {
+        return {};
+      };
+    }
+    return new Function('api', 'templateRootEl', 'props', code);
+  }
+
+  const state = {
+    initialized: false,
+    projectId: null,
+    apiKey: null,
+    apiUrl: '',
+    cssIsolation: 'scoped',
+    components: {},
+  };
+
+  function registerComponent(def) {
+    const code = toStr(def.code).trim().toLowerCase();
+    if (!code) return;
+
+    const version = def.version;
+    const html = def.html;
+    const js = def.js;
+    const css = def.css;
+
+    ensureTemplate(code, html);
+
+    const component = {
+      code,
+      version,
+      css,
+      js,
+      create: function (props, options) {
+        const opts = options || {};
+        const mountEl = opts.mountEl || defaultMountTarget();
+        const isolation = opts.cssIsolation || state.cssIsolation;
+
+        const tpl = ensureTemplate(code, html);
+        const fragment = tpl.content.cloneNode(true);
+
+        let templateRootEl;
+        let instanceRoot;
+        let shadow = null;
+
+        if (isolation === 'shadow') {
+          const c = createShadowRootContainer();
+          instanceRoot = c.host;
+          shadow = c.shadow;
+          templateRootEl = shadow;
+          if (css) {
+            const style = document.createElement('style');
+            style.textContent = toStr(css);
+            shadow.appendChild(style);
+          }
+          shadow.appendChild(fragment);
+        } else {
+          instanceRoot = document.createElement('div');
+          templateRootEl = instanceRoot;
+          if (css) injectCssScoped(code, css);
+          instanceRoot.appendChild(fragment);
+        }
+
+        mountEl.appendChild(instanceRoot);
+
+        const api = {
+          unmount: function () {
+            try {
+              instanceRoot.remove();
+            } catch {}
+          },
+          mountEl,
+          hostEl: instanceRoot,
+          shadowRoot: shadow,
+        };
+
+        const fn = compileComponentJs(js);
+        let exported = {};
+        try {
+          exported = fn(api, templateRootEl, props || {}) || {};
+        } catch (e) {
+          exported = {
+            error: e,
+          };
+        }
+
+        return Object.assign({ api }, exported);
+      },
+    };
+
+    state.components[code] = component;
+    uiCmp[code] = component;
+    uiComponents[code] = component;
+  }
+
+  async function init(options) {
+    const opts = options || {};
+    const projectId = toStr(opts.projectId).trim();
+    if (!projectId) throw new Error('projectId is required');
+
+    const apiUrl = normalizeApiUrl(opts.apiUrl);
+    const apiKey = opts.apiKey;
+
+    state.projectId = projectId;
+    state.apiKey = apiKey;
+    state.apiUrl = apiUrl;
+
+    const cssIsolation = toStr(opts.cssIsolation || 'scoped').trim().toLowerCase();
+    state.cssIsolation = cssIsolation === 'shadow' ? 'shadow' : 'scoped';
+
+    const base = state.apiUrl;
+    const url = base + '/api/ui-components/projects/' + encodeURIComponent(projectId) + '/manifest';
+
+    const data = await fetchJson(url, buildHeaders(apiKey));
+    const items = data && Array.isArray(data.components) ? data.components : [];
+
+    for (const def of items) {
+      registerComponent(def);
+    }
+
+    state.initialized = true;
+    return { project: data ? data.project : null, count: items.length };
+  }
+
+  async function load(code) {
+    const c = toStr(code).trim().toLowerCase();
+    if (!c) throw new Error('code is required');
+    if (!state.projectId) throw new Error('uiCmp not initialized');
+    if (state.components[c]) return state.components[c];
+
+    const base = state.apiUrl;
+    const url =
+      base +
+      '/api/ui-components/projects/' +
+      encodeURIComponent(state.projectId) +
+      '/components/' +
+      encodeURIComponent(c);
+
+    const data = await fetchJson(url, buildHeaders(state.apiKey));
+    if (!data || !data.component) throw new Error('Component not found');
+
+    registerComponent(data.component);
+    return state.components[c];
+  }
+
+  const uiCmp = {
+    init,
+    load,
+    _state: state,
+  };
+
+  const uiComponents = uiCmp;
+
+  window.uiCmp = uiCmp;
+  window.uiComponents = uiComponents;
+})();